home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / globe103.zip / GLOBE.DOC < prev    next >
Text File  |  1990-10-08  |  9KB  |  264 lines
  1. NAME
  2.     globe
  3.  
  4. SYNOPSIS
  5.     globe  [file1 file2...]  [options]
  6.  
  7. DESCRIPTION
  8.     GLOBE accepts a file of triples of numbers, the X, Y, and Z
  9.     coordinates of points, and displays a perspective projection of
  10.     them as points or connected by lines.  The user can then alter his
  11.     vantage point with the cursor keys, and the display is redrawn.
  12.  
  13.     GLOBE is like DOTS, except that GLOBE also draws a unit sphere
  14.     centered at the origin and removes all the lines and markers hidden
  15.     by it.
  16.  
  17.     A user may want to enhance the GLOBE display by including
  18.     latitude/longitude lines generated by LATLONG and/or the world
  19.     coastline points generated by WORLD.
  20.  
  21.     Key commands available:
  22.  
  23. Cursor keys move observer higher, lower, around to left, or around to right.
  24. +        enlarge cursor key steps by a factor of 4
  25. -        shrink cursor key steps by a factor of 4
  26. pg up    move viewpoint closer
  27. pg dn    move viewpoint further away
  28. home     enlarge display (factor 1.414)
  29. end      shrink display (factor .707)
  30. q        exit program
  31. ?        print this help menu
  32.  
  33.     Using the photographic analogy, <home> and <end> correspond to
  34.     changing the focal length of the lens, while <pg up> and <pg dn>
  35.     correspond to moving the photographer.  The camera always points
  36.     toward the "view reference point", which is the center of the box
  37.     enclosing the data.
  38.  
  39.     With parallel perspective, the distance from the viewpoint to the
  40.     displayed data would make no difference in the display, so the <pg
  41.     up> and <pg dn> keys instead have the same effect as the <home> and
  42.     <end>, respectively.
  43.  
  44. OPTIONS
  45.  
  46.     These options are specific to GLOBE...
  47.  
  48.    -ll          input is longitude-latitude pairs in degrees.  All points
  49.                 are assumed to be at radius 1 from the origin.
  50.    -r <radius>  specify sphere radius (default 1)
  51.  
  52.     The default condition for two options is opposite that for DOTS...
  53.  
  54.    -f           add axes and frame around plot
  55.    -p       use perspective rather than parallel projection (faster, 
  56.            but one less depth cue)
  57.  
  58.     Otherwise, GLOBE accepts the same options as DOTS...
  59.  
  60.    &<name>    (hard copy versions only) Device driver switches are 
  61.         in the configuration file <name>.  See "DEVICE DRIVER 
  62.         CONFIGURATION FILES" below.
  63.    -a [step [start]] automatic abscissas 
  64.    -b       break graph after each label
  65.    -m  n1 n2 n3...
  66.         The numeric arguments are linestyles for successive
  67.         line segments (see switch -b).  Each positive argument
  68.         is a number of up to three digits WCS, where
  69.             W is the linewidth (0-9, with 0 giving width 1), 
  70.             C is the color (with 0 being brightest), and 
  71.             S is linestyle (1-5, 1 for solid, 2 for dashed,
  72.                 3 for dotted, etc.) 
  73.         If an argument is zero, the data points are plotted as
  74.         dots not connected by lines.  Similarly, a negative
  75.         argument -CS generates a marker:
  76.             C is the color
  77.             S is the marker style (dot, box, cross, etc.)
  78.  
  79.    -o  ox oy oz       
  80.                 specify initial observer location (especially useful
  81.                 for hard copy output devices)
  82.    -s  num      enlarge the display by a factor num.
  83.    -t       draw line from each data point to the XY plane
  84.    -x  NUM1 NUM2  let x axis extend from NUM1 to NUM2
  85.    -y  NUM1 NUM2  let y axis extend from NUM1 to NUM2
  86.    -z  NUM1 NUM2  let z axis extend from NUM1 to NUM2
  87.  
  88. BUGS
  89.     Axis labels would help.  Most of the options for the Unix utility
  90.     GRAPH would help.  
  91.  
  92. EXAMPLE
  93.     To display a map of the world, enter
  94.  
  95.         globe world8 -ll -m 164*60
  96.                          ^^^^^^^^^  specifies blue lines for 
  97.                                        the 164 lines in the file
  98.                      ^^^  longitude/latitude input
  99.               ^^^^^^  the input file
  100.  
  101.     WORLD8 is a data file of world coastline points, and can be found in
  102.     WORLD.ZIP.
  103.  
  104. VERSIONS
  105.     GLOBE is available in several versions.  When necessary for
  106.     configuration control, these versions are given different file
  107.     names (see FILES section below).  It is suggested that the
  108.     "normal" version for a given computer be renamed GLOBE for
  109.     simplicity.  Any version of GLOBE can be executed with a
  110.     question mark as the only parameter:
  111.  
  112.         GLOBE ?
  113.  
  114.     It will then print a help screen which includes the hardware it
  115.     supports, and exit immediately.  In addition, GLOBE tests that the
  116.     hardware it needs is present before using it (except for the hard
  117.     copy versions).
  118.  
  119.     For the display version of GLOBE, you will need a device driver in the
  120.     form of a .BGI (for Borland Graphics Interface) appropriate for
  121.     your hardware.  If you have one of the following standard graphics
  122.     cards, you can use one of those supplied by Borland:
  123.  
  124.         CGA
  125.         MCGA
  126.         EGA
  127.         ATT400
  128.         VGA
  129.         PC3270
  130.         IBM8514
  131.         Hercules mono
  132.  
  133.     If so, you need only put the .BGI file where GLOBE can find it. 
  134.     GLOBE will look in the directories listed in the environment
  135.     variable BGIPATH if it is set, otherwise it will look in the
  136.     directories indicated by PATH.  For example:
  137.  
  138.         C>set bgipath=C:\MY\BGIFILES;C:\TC\BGI
  139.         C>globe mydata
  140.  
  141.     If you put both GLOBE.EXE and the required .BGI file into one of the
  142.     directories in your PATH, you will not need to add anything
  143.     to your environment.
  144.  
  145.     If you want to select a particular graphics mode, you may set the
  146.     environment variable GRAPHMODE to one of the numeric constants of
  147.     "graphics_modes" enumeration type as defined by Borland.  The
  148.     constants are as follows:
  149.  
  150.                mode           value
  151.     ------------------    -----
  152.     CGA    320*200    C0    0
  153.     CGA    320*200    C1    1
  154.     CGA    320*200    C2    2
  155.     CGA    320*200    C3    3
  156.     CGA    640*200     4
  157.  
  158.     MCGA    320*200 C0    0
  159.     MCGA    320*200 C1    1
  160.     MCGA    320*200 C2    2
  161.     MCGA    320*200 C3    3
  162.     MCGA    640*200        4
  163.     MCGA    640*480        5
  164.  
  165.     EGA    640*200        0
  166.     EGA    640*350        1
  167.     EGAMONO    640*350        3
  168.  
  169.     HERC    720*348        0
  170.  
  171.     ATT400    320*200    C0    0
  172.     ATT400    320*200    C1    1
  173.     ATT400    320*200    C2    2
  174.     ATT400    320*200    C3    3
  175.     ATT400    640*200        4
  176.     ATT400    640*400        5
  177.  
  178.     VGA    640*200        0
  179.     VGA    640*350        1
  180.     VGA    640*480        2
  181.  
  182.     PC3270    720*350        0
  183.  
  184.     IBM8514    640*480        0
  185.         1024*768    0
  186.  
  187.     ...where C0, C1, C2, and C3 refer to the four palettes on the CGA
  188.     and compatible systems.
  189.  
  190.     If you have nonstandard video hardware, you will have to obtain or
  191.     write a .BGI file.  In that case, set the environment variable
  192.     BGIDRIVER to the name of the file.  For example, if your driver
  193.     is named SGA.BGI, you would set the environment variable as
  194.     follows:
  195.  
  196.         C>set bgidriver=SGA
  197.  
  198.     No hardware autodetection of nonstandard video cards is supported.
  199.  
  200. FILES
  201.     GLOBE.EXE     for EGA
  202.     GLOBEPS.EXE   for Postscript
  203.     GLOBELI.EXE   for CIE Laser Image Printing System, or LIPS 10
  204.  
  205. DEVICE DRIVER CONFIGURATION FILES
  206.  
  207.     The hard copy versions (GLOBEHI, GLOBEHP, GLOBELI, GLOBEPS) can also
  208.     accept parameters from an ASCII configuration file.  Entries in
  209.     the file are switches, some with arguments, similar to those
  210.     used on the command line.  The following switches are available:
  211.  
  212.     -p        portrait orientation (LI and PS only)
  213.     -l        landscape orientation (the default) (LI and PS only)
  214.     -o <xoffset> <yoffset>
  215.     -r <xoffset>
  216.     -d <yoffset>
  217.             offset in inches from top left corner of page
  218.     -s <width> <height>
  219.     -w <width>
  220.     -h <height>
  221.             plot size in inches 
  222.     -f <name>    name of output file (or port)
  223.     -v <velocity>    pen velocity (HP and HI versions only).
  224.             Units are cm/sec for HP and in/sec for HI.
  225.     -n <name>    Plotter name (HI version only).  Choices
  226.             are "DMP-29" (the default) and "DMP-7".  Case is not
  227.             distinct, and "29" and "7" are also accepted.
  228.  
  229.     None of the arguments can be omitted.  A semicolon introduces a
  230.     comment that extends to the end of the line.
  231.  
  232.     A switch may start with '+' instead of '-', in which case it will
  233.     establish the default, but the program will still ask for the
  234.     final value.
  235.  
  236.     The PostScript device driver configuration file name will be, in
  237.     decreasing order of priority:
  238.  
  239.         1. An "&filename" entry on the command line 
  240.         2. GRAPHPS.CFG in the current directory.
  241.  
  242.     The Houstin Instruments version would look for a configuration
  243.     file named GRAPHHI.CFG, etc.  If more than one &filename entry
  244.     appears, only the last